Release Notes 8.3 by rasika-chivate · Pull Request #1149 · percona/psmdb-docs

rasika-chivate · 2026-07-22T09:04:26Z

Create release notes for version 8.3.
Update configuration files.
Include a version selector for 8.3.

alina-derkach-oaza · 2026-07-22T14:47:27Z

You need to update the config files in _resourcepdf/overrides instead of _resource/overrides
You need to update mkdocs-base.yml with the new version
To add a new version to the version switcher, you need to update .github/workflows/main.yml file in 8.3 branch. And then update the same file in 8.0 version to make it look the same as in 7.0 version. So 8.3 is the (Latest) version, and 8.0 is a standard version like 7.0.

Copilot

Pull request overview

Copilot reviewed 23 out of 23 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (1)

docs/release_notes/8.3.4-1.md:83

This sentence has two issues: (1) missing space after "and" (renders as "andCompatibility"), and (2) the "Release Notes for MongoDB 8.3" link text points to the 8.3 compatibility URL, which is inconsistent with the label and duplicates the second link.

For the complete list of upstream changes, see [Release Notes for MongoDB 8.3 :octicons-link-external-16:](https://www.mongodb.com/docs/manual/release-notes/8.3-compatibility/){:target="_blank"} and[ Compatibility Changes in MongoDB 8.3 :octicons-link-external-16:](https://www.mongodb.com/docs/manual/release-notes/8.3-compatibility/){:target="_blank"}.

  - Release notes:
      - "Release notes index": "release_notes/index.md"
-      - release_notes/8.0.26-11.md
-      - release_notes/8.0.23-10.md
-      - release_notes/8.0.21-9.md
-      - release_notes/8.0.20-8.md
-      - release_notes/8.0.19-7.md
-      - release_notes/8.0.17-6.md
-      - release_notes/8.0.16-5.md
-      - release_notes/8.0.12-4.md
-      - release_notes/8.0.8-3.md
-      - release_notes/8.0.4-2.md
-      - release_notes/8.0.4-1.md
+      - release_notes/8.3.4-1.md
  - faq.md


Copilot

Pull request overview

Copilot reviewed 23 out of 23 changed files in this pull request and generated 2 comments.

Comments suppressed due to low confidence (3)

docs/install/upgrade-from-80.md:3

The upgrade guide title now says 8.0 → 8.3, but the body still contains multiple 8.0-specific references (e.g., MongoDB 8.0 compatibility link, enabling the psmdb-80 repository, and instructions that appear to install 8.0 packages). This makes the page misleading for 8.3 upgrades; please update the remaining content to consistently target 8.3 (including repo/channel names and external links).
.github/workflows/main.yml:47
The steps list indentation is inconsistent here (the - name: Deploy docs item is indented one space deeper than other step items). This can make the workflow YAML invalid or change the structure unexpectedly.

      - name: Deploy docs
        run: |
          mike deploy 8.3 -b publish -p

docs/release_notes/8.3.4-1.md:6

This --- line will render as a horizontal rule at the top of the page. Since the repo uses the Markdown meta extension (mkdocs-base.yml), you can terminate the metadata block with a blank line instead, avoiding the extra rendered HR.

---

nastena1606 · 2026-07-23T13:36:56Z

@@ -0,0 +1,103 @@
+title: Percona Server for MongoDB release notes version 8.3.4-1
+summary: Get to know all improvements, new features, and bug and security vulnerability fixes in the release


the sentence has no ending

nastena1606 · 2026-07-23T13:38:26Z

+
+## Upgrade considerations
+
+To upgrade to MongoDB 8.3 from an 8.0 deployment, the deployment must have `featureCompatibilityVersion` set to 8.0.


Maybe add the link to the upgrade guide?

nastena1606 · 2026-07-23T13:38:48Z

+To check the version:
+
+```javascript
+db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )


Output will be welcome here, so that users see what to expect

nastena1606 · 2026-07-23T13:39:59Z

+
+SBOMs are distributed through the following channels:
+
+- GitHub: The latest SBOM is placed in the root of the `percona/percona-server-mongodb` main branch.


main? Are they the same for every version? Main is not stable as I remember, why would I pull SBOMs for my 8.0 or 7.0 from main?

in the root of the percona/percona-server-mongodb main branch.

This is true but this is not the full truth. Each of the following branches in percona/percona-server-mongodb repository:

master (which was referenced to as "main", I guess),

v8.3

v8.0,

v7.0

actually has its own SBOM. But those per-branch SBOMs are "generic". The final specific SBOMs that get to the deb, rpm, and tar.gz binary packages are generated during packaging by replacing some metainfo in "generic" SBOMs with release-specific values.

Strictly speaking, SBOMs are not "distributed" via GitHub. Their "generic" prototypes are kept there, and a user should not care about that.

Long story short, I suggest removing the whole GitHub bullet point.

nastena1606 · 2026-07-23T13:40:29Z

+
+- GitHub: The latest SBOM is placed in the root of the `percona/percona-server-mongodb` main branch.
+
+- Binaries/Tarballs: An SBOM file is included in `doc/percona-server-mongodb/sbom.cdx.json`


And here they are release specific.

If we remove the GitHub bullet point as suggested above, this one is OK semantically.

I would tune the wording, though. In my humble opinion, the "Binaries" word is somewhat confusing, I'd remove it.

Next, the phrase "An SBOM file is included in doc/percona-server-mongodb/sbom.cdx.json" sounds slightly strange. In the phrase, doc/percona-server-mongodb/sbom.cdx.json is a file, and we get that "An SBOM file is included in file". It makes sense to remove the first "file" word and choose another verb instead of "included".
Combining with a previous point, we can have something like:

- Tarballs: An SBOM is located in the `doc/percona-server-mongodb/sbom.cdx.json` file.

nastena1606 · 2026-07-23T13:41:40Z

+
+#### Query planning and aggregation
+
+The `$scoreFusion` aggregation stage is now generally available, and new expressions support hashing, Extended JSON conversion, binary subtypes, and `ObjectId` generation.


Was it tech preview before? In what version? What's the value of it?

it was Public Preview (term that upstream use). But we haven't released 8.3.x before - so at Percona we did not have that.

nastena1606 · 2026-07-23T13:43:16Z

+
+* [PSMDB-2150](https://perconadev.atlassian.net/browse/PSMDB-2150): Percona Server for MongoDB (PSMDB) now provides Software Bills of Materials (SBOMs) for every release.
+
+* [PSMDB-2003](https://perconadev.atlassian.net/browse/PSMDB-2003): We have implemented caching of LDAP `userToDNMapping` to reduce the number of round-trips to the LDAP server during authentication and authorization. Caching is controlled by `security.ldap.userToDNMapping` (exposed as `--ldapUserToDNMapping` at startup and `ldapUserToDNMapping` at runtime). For detailed information, see our [documentation](https://docs.percona.com/percona-server-for-mongodb/8.3/ldap-parameters.html).


Not sure using "we" is appropriate. Rephrase to "Added caching of LDAP...."

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 23 out of 23 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (2)

docs/release_notes/8.3.4-1.md:6

YAML front matter is missing the opening --- delimiter. With only a closing delimiter present, MkDocs won’t parse title/authors/version, and {{ page.meta.version }} in the heading will render empty. Add the opening delimiter and normalize the authors indentation.

title: Percona Server for MongoDB release notes version 8.3.4-1
summary: Get to know all improvements, new features, and bug and security vulnerability fixes in the release
authors:
    - Rasika Chivate
version: 8.3.4-1
---

docs/install/upgrade-from-80.md:6

The page title/intro now says this is an 8.0 → 8.3 upgrade guide, but the rest of the document still contains 7.0/8.0-specific instructions and references (e.g., MongoDB 8.0 compatibility link, enabling psmdb-80, setting FCV to 8.0, and text saying the upgrade starts with the 7.0 feature set). This makes the guide internally inconsistent and potentially misleading; the remaining steps need to be updated for 8.3.

Release Notes 8.3

45a1321

rasika-chivate deployed to Release-Notes-8.3 - psmdb-docs-8.3 PR #1149 July 22, 2026 09:04 — with Render View deployment

rasika-chivate marked this pull request as draft July 22, 2026 09:04

Update 8.3.4-1.md

37a6436

rasika-chivate deployed to Release-Notes-8.3 - psmdb-docs-8.3 PR #1149 July 22, 2026 13:39 — with Render View deployment

Update 8.3.4-1.md

d82cf79

rasika-chivate deployed to Release-Notes-8.3 - psmdb-docs-8.3 PR #1149 July 22, 2026 13:49 — with Render View deployment

update config files

a12dd4c

rasika-chivate deployed to Release-Notes-8.3 - psmdb-docs-8.3 PR #1149 July 22, 2026 14:19 — with Render View deployment

update files

990bdcd

rasika-chivate deployed to Release-Notes-8.3 - psmdb-docs-8.3 PR #1149 July 22, 2026 14:32 — with Render View deployment

update config files

1277eb4

rasika-chivate deployed to Release-Notes-8.3 - psmdb-docs-8.3 PR #1149 July 22, 2026 14:36 — with Render View deployment

Update main.yml

b4a1138

rasika-chivate deployed to Release-Notes-8.3 - psmdb-docs-8.3 PR #1149 July 22, 2026 14:42 — with Render View deployment

update the correct files

a3196a6

rasika-chivate deployed to Release-Notes-8.3 - psmdb-docs-8.3 PR #1149 July 22, 2026 14:44 — with Render View deployment

Update variables.yml

b254cd1

rasika-chivate deployed to Release-Notes-8.3 - psmdb-docs-8.3 PR #1149 July 22, 2026 14:45 — with Render View deployment

alina-derkach-oaza reviewed Jul 22, 2026

View reviewed changes

Comment thread docs/release_notes/index.md Outdated

alina-derkach-oaza reviewed Jul 22, 2026

View reviewed changes

Comment thread variables.yml Outdated

changed index files

38fbb84

rasika-chivate deployed to Release-Notes-8.3 - psmdb-docs-8.3 PR #1149 July 22, 2026 14:51 — with Render View deployment

Update variables.yml

c3e588e

rasika-chivate deployed to Release-Notes-8.3 - psmdb-docs-8.3 PR #1149 July 22, 2026 14:52 — with Render View deployment

alina-derkach-oaza reviewed Jul 22, 2026

View reviewed changes

Comment thread _resource/overrides/main.html Outdated

alina-derkach-oaza reviewed Jul 22, 2026

View reviewed changes

Comment thread _resourcepdf/overrides/main.html Outdated

Update 8.3.4-1.md

f53ebd8

rasika-chivate deployed to Release-Notes-8.3 - psmdb-docs-8.3 PR #1149 July 23, 2026 07:20 — with Render View deployment

rasika-chivate requested a review from Copilot July 23, 2026 13:17

Copilot started reviewing on behalf of rasika-chivate July 23, 2026 13:18 View session

Copilot started work on behalf of rasika-chivate July 23, 2026 13:19 View session

Copilot AI reviewed Jul 23, 2026

View reviewed changes

Fix spacing in MongoDB 8.3 compatibility links

cf88f41

rasika-chivate deployed to Release-Notes-8.3 - psmdb-docs-8.3 PR #1149 July 23, 2026 13:21 — with Render View deployment

rasika-chivate requested review from alina-derkach-oaza, Copilot and nastena1606 July 23, 2026 13:22

Copilot finished work on behalf of rasika-chivate July 23, 2026 13:22

Copilot started reviewing on behalf of rasika-chivate July 23, 2026 13:22 View session

Copilot AI reviewed Jul 23, 2026

View reviewed changes

Comment thread docs/release_notes/8.3.4-1.md Outdated

Comment thread docs/release_notes/8.3.4-1.md Outdated

nastena1606 reviewed Jul 23, 2026

View reviewed changes

Potential fix for pull request finding

f32796c

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

rasika-chivate deployed to Release-Notes-8.3 - psmdb-docs-8.3 PR #1149 July 24, 2026 06:12 — with Render View deployment

Potential fix for pull request finding

1bef882

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

rasika-chivate deployed to Release-Notes-8.3 - psmdb-docs-8.3 PR #1149 July 24, 2026 06:13 — with Render View deployment

rasika-chivate requested a review from Copilot July 24, 2026 06:16

Copilot started reviewing on behalf of rasika-chivate July 24, 2026 06:16 View session

Copilot started work on behalf of rasika-chivate July 24, 2026 06:17 View session

Copilot AI reviewed Jul 24, 2026

View reviewed changes

Fix broken 8.0.12-4 release note links in version-added notes

114d8f1

rasika-chivate deployed to Release-Notes-8.3 - psmdb-docs-8.3 PR #1149 July 24, 2026 06:21 — with Render View deployment

Copilot finished work on behalf of rasika-chivate July 24, 2026 06:21

		@@ -0,0 +1,103 @@
		title: Percona Server for MongoDB release notes version 8.3.4-1
		summary: Get to know all improvements, new features, and bug and security vulnerability fixes in the release


		## Upgrade considerations

		To upgrade to MongoDB 8.3 from an 8.0 deployment, the deployment must have `featureCompatibilityVersion` set to 8.0.


		SBOMs are distributed through the following channels:

		- GitHub: The latest SBOM is placed in the root of the `percona/percona-server-mongodb` main branch.


		- GitHub: The latest SBOM is placed in the root of the `percona/percona-server-mongodb` main branch.

		- Binaries/Tarballs: An SBOM file is included in `doc/percona-server-mongodb/sbom.cdx.json`


		#### Query planning and aggregation

		The `$scoreFusion` aggregation stage is now generally available, and new expressions support hashing, Extended JSON conversion, binary subtypes, and `ObjectId` generation.


		* [PSMDB-2150](https://perconadev.atlassian.net/browse/PSMDB-2150): Percona Server for MongoDB (PSMDB) now provides Software Bills of Materials (SBOMs) for every release.

		* [PSMDB-2003](https://perconadev.atlassian.net/browse/PSMDB-2003): We have implemented caching of LDAP `userToDNMapping` to reduce the number of round-trips to the LDAP server during authentication and authorization. Caching is controlled by `security.ldap.userToDNMapping` (exposed as `--ldapUserToDNMapping` at startup and `ldapUserToDNMapping` at runtime). For detailed information, see our [documentation](https://docs.percona.com/percona-server-for-mongodb/8.3/ldap-parameters.html).

Uh oh!

Conversation

rasika-chivate commented Jul 22, 2026

Uh oh!

alina-derkach-oaza commented Jul 22, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ktrushin Jul 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

ktrushin Jul 24, 2026 •

edited

Loading